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1.  !  INTRODUCTION 


This\  document  describes  the  procedures  for  installing  and  con¬ 
ducting  the  installation  and  acceptance  testing  of  AISIM  Version 
2.0.  ^Comprehensive  testing  of  a  system  can  be  divided  into  three 
categories:  component  testing,  integration  testing,  and  demons¬ 
tration  testing. 

Component  testing  is  intended  to  verify  that  each  system  com¬ 
ponent  works  properly.  Such  testing  is  the  sole  responsibility 
of  the  developers  and,  therefore,  is  beyond  the  scope  of  this 
document . 

Integration  testing  is  intended  to  show  that  all  the  components 
operate  together  properly.  This  testing  is  planned  and  performed 
by  the  developers. 

Demonstration  testing  is  intended  to  show  that  the  system  meets 
its  functional  requirements.  This  testing  is  broken  into  two 
phases:  1)  installation  testing  and  2)  acceptance  testing. 

Hughes  has  developed  the  procedures  for  performing  these  tests 
and  they  are  contained  herein.  Testing  should  be  performed  by 
personnel  representing  the  contractor  and  the  customer. 

This  document  also  contains  a  description  of  the  contents  of  the 
system  tape  -  its  files  and  organization.  The  procedures  for 
loading  this  tape  on  the  host  computer  and  then  building  the 
AISIM  system  are  described  in  detail. 
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2.  SYSTEM  GENERATION  PROCEDURES 


The  data  necessary  to  install  AISIM  on  a  suitable  computer  system 
are  described  in  this  section. 

2. 1  Host  System  Requirements 

Before  AISIM  can  be  installed  on  a  computer  (or  "host")  system, 
the  following  constraints  must  be  satisfied: 

1.  The  prospective  host  must  have  an  interactive  operating  sys¬ 
tem  that  is  compatible  with  IBM  370  file  structures; 

2.  A  FORTRAN  IV  compiler  must  be  available; 

3.  A  SIMSCRIPT  II. 5  compiler  must  be  available; 

4.  A  copy  of  the  PLOTIO*  package  must  be  available; 

5.  The  host  must  have  the  memory  capacity  to  handle  the  largest 
load  module  (i.e.,  the  DESIGN  program:  868,648  bytes),  or 
the  ability  to  segment  load  modules  into  manageable  chunks. 

If  any  of  these  conditions  are  not  met,  AISIM  cannot  be  success¬ 
fully  installed  on  that  system. 

2 . 2  Rehosting  AISIM 

There  are  two  different  scenarios  to  which  this  section  is 
directed.  The  first  is  the  user  who  has  an  IBM  370/MVS  EXTENDED 
TSO  machine  and  wants  to  get  AISIM  up  as  quickly  as  possible. 
After  dumping  the  files  from  the  tape,  this  user  should  only  have 
to  alter  the  CLISTS  and  will  then  be  able  to  execute  the  system. 
Section  2.3  describes  how  to  dump  the  files  from  the  tape  and 
section  2.4.2  describes  how  to  set  up  the  CLISTS  to  execute  AISIM 
on  the  new  host  system. 

The  second  scenario  is  the  user  who  determines  that  the  operating 
system  of  the  target  host  machine  is  not  exactly  compatible  with 
IBM  370/MVS  EXTENDED  TSO.  In  this  case  the  user  wili  have  to  do 
more  work,  the  amount  being  relative  to  the  number  of  system 
incompatibilities.  The  user  wili  probably  have  to  recompile  the 
source  files,  create  new  data  bases,  and  bring  AISIM  up  from 
scratch.  This  user  should  consult  section  2.3.1  on  dumping  the 
files  from  the  tape  and  section  2.4.3  on  bringing  AISIM  up  from 
scratch. 

2 . 3  Reading  the  AISIM  Tapes 

Following  is  a  list  of  the  types  of  files  which  are  on  the  AISIM 
tapes . 


Page  2 


1.  Fortran  source  files:  xxxx.fort  -  The  Fortran  routines  make 
up  the  source  for  the  Design,  Replot,  and  Hardcopy  Func¬ 
tions,  the  translator,  and  the  user  interface  for  the 
Analyze  and  Library  Functions. 

2.  The  AIS.GFM.DATA,  AIS. CHECKIN. DATA,  and  AIS . MERGEIN. DATA 
files  -  These  are  the  simscript  II. 5  source  code  for  the 
AIS IM  simulator  and  Library  Function.  These  programs  are 
spiit  up  into  functional  parts  and  stored  in  partitioned 
data  sets  (PDS) . 

3.  Load  Modules:  AIS. SYSTEM. LOAD  and  AIS . LIBUTI L. LOAD  -  These 
are  the  load  modules  for  executing  the  AISIM  system. 

4.  CLISTS:  xxxx.clist  -  These  are  the  command  procedures  that 
are  executed  to  build  and  run  the  system. 

5.  Data  Bases:  xxxx.dbf  -  These  are  the  initialized  AISIM  start 
data  bases,  the  System  Library  data  base,  and  the  data  bases 
to  be  used  in  conjunction  with  the  test  procedures  for  veri¬ 
fying  the  operation  of  AISIM. 

6.  JCL  files:  CRKEX1 . CNTL  and  CRKSR1 . CNTL  -  These  are  Job  Con¬ 
trol  Language  (JCL)  files  which  will  dump  the  files  from  the 
tapes  to  a  disk. 

7.  Miscellaneous  files:  everything  else  -  These  include  the 
data  base  schemas  and  data  used  to  initialize  AISIM  data 
bases. 

Note:  There  are  no  object  files  contained  on  these  tapes.  The 
IBM  utilities  used  to  create  the  tapes  were  IEBCOPY  for  the  PDS's 
and  IEBGENER  for  the  sequential  data  sets.  In  order  to  make 
unloading  the  tapes  as  easy  as  possible,  a  file  has  been  placed 
on  each  of  the  tapes  to  read  the  tape  files  to  disk.  These  files 
also  use  IEBCOPY  and  IEBGENER  to  handle  the  PDS's  and  sequential 
data  sets,  respectively.  These  files  must  be  modified  before 
they  can  be  executed: 

1.  The  data  set  names  in  the  JCL,  indicating  the  names  under 
which  the  files  are  to  be  placed  on  the  disk,  must  be  fully 
qualified  (without  quotes).  The  JCL  file  must  be  modified 
to  reference  the  account  where  the  AISIM  files  are  to  be 
piaced:  ail  occurrences  of  't******'  must  be  changed  to  the 
appropriate  identification  of  the  account  where  the  AISIM 
files  are  to  reside. 

2.  The  output  disk  where  the  files  are  to  be  placed  must  be 
specified.  Aii  instances  of  'TSO###'  must  be  changed  to 
reference  a  valid  disk  unit.  All  references  to  UNIT  should 
be  changed  to  the  appropriate  reference. 
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3.  Finally,  the  serial  number  of  the  tape  must  be  specified. 
This  name  or  number  is  assigned  to  the  tape  before  it  is 
mounted.  The  JCL  assumes  the  tapes  will  be  named  AISSR1  and 
AISEX1,  but  this  should  be  changed  to  be  compatible  with  the 
actual  labelling. 

Following  are  the  JCL  files  for  retrieving  the  JCL  files  from  the 
tapes.  These  programs  will  retrieve  the  JCL  files  which  will 
read  the  files  off  of  the  tapes.  These  JCL  programs  must  be 
written  and  modified  as  outlined  in  the  above  three  steps.  They 
can  then  be  submitted  to  read  from  the  tape  the  files  which  will 
load  ail  of  the  AISIM  files.  The  retrieved  JCL  files  will  be 
placed  on  the  disk  under  the  names  CRKSR1.CNTL  and  CRKEX1.CNTL. 

//  EXEC  PGM=I EBGENER 
//SYSPRINT  DD  SYSOUT®A 
//SYSIN  DD  DUMMY 

/ /SYSUT1  DD  UNIT=TAPE,V0L=SER*AISSR1,SPACE=(1, (1,1) ) , 

//  LABEL® (39, NL) ,DISP= (OLD, PASS, KEEP) , 

//  DCB® (RECFM®FB,LRECL=80, BLKSIZ  E®6 160 , DEN=3 ) 

/ /SYSUT2  DD  DSN®T ******. CRKSR1 . CNTL, 

//  UNIT=DISK , DISP® (NEW , CATLG, CATLG) , V0L*SER=TS0### , 

//  SPACE® (TRK, (1,1) ,RLSE) , 

//  DCB=(RFCFM®FB,LRECL=80,BLKSIZE=6160) 

/* 

//  EXEC  PGM®I EBGENER 
//SYSPRINT  DD  SYS0UT®A 
//SYSIN  DD  DUMMY 

//SYSUT1  DD  UNIT=TAPE, V0L=SER=AISEX1, SPACE® (1, (1,1) ) , 

//  LABEL® (20, NL) ,DISP= (OLD, PASS, KEEP) , 

//  DCB® (RECFM*FB ,LRECL*80,BLKSIZE=6160, DEN® 3) 

//SYSUT2  DD  DSN=T****** .CRKEX1 . CNTL, 

//  UNIT®DISK,DISP»(NEW, CATLG, CATLG) , VOL=SER=TSO# # # , 

//  SPACE® (TRK, (1,1) ,RLSE) , 

//  DCB® (RECFM*FB , LRECL=80 , BLKSIZ  E=6 160) 

/* 

After  the  above  changes  have  been  made  to  the  JCL  files 
( CRKEX1 . CNTL  and  CRKSR1 . CNTL)  from  the  tape,  these  files  should 
execute  without  further  difficulty.  An  attempt  has  been  made  to 
supply  an  of  the  necessary  parameters  to  the  JCL  files,  but  if 
necessary,  the  files  can  be  altered  to  suit  specific  needs.  How¬ 
ever,  the  input  DCB  paramenters  should  not  be  changed  because  the 
current  parameters  will  ensure  that  the  files  are  read  correctly 
from  the  tape.  Likewise  the  space  allocations  should  be  altered 
with  care.  If  the  space  on  the  disk  upon  which  the  fiies  are  to 
reside  is  higiy  fragmented,  it  may  be  necessary  to  increase  the 
allocations,  but  the  allocations  presently  in  the  JCL  file  are 
the  smallest  possible  with  a  margin  of  safety  to  ensure  that 
there  is  enough  space  for  normal  allocation  of  the  files. 

Note:  When  the  AISIM  files  are  dumped  from  the  tapes  to  disk. 
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there  must  not  already  exist  on  the  disk  any  files  with  the  same 
names  as  those  assigned  to  the  files  on  the  tape.  If  files  by 
those  names  already  exist,  the  tape  files  with  the  duplicate 
names  will  not  be  dumped  from  the  tape.  If  there  are  problems 
executing  the  JCL  file,  consult  the  IBM/MVS  JCL  manual. 

2.3.1  Contents  of  the  Tape  The  following  is  a  list  of  ail  the 
data  sets  in  the  order  in  which  they  appear  on  the  tapes,  along 
with  a  brief  description  of  each  data  set  and  its  organization: 
PDS  for  partitioned  data  set  and  SEQ  for  sequential  data  set. 

Tape  AISSRl: 


AIS. DDL. DATA 

-  This 
base . 

is  the  schema 
(SEQ) 

for 

the 

design  data 

AIS. MODEL. DDL. DATA 

-  This  is  the  schema 
data  base.  (SEQ) 

for 

the 

library  model 

AIS. PLOT. DDL. DATA 

-  This 
(SEQ) 

is  the  schema 

for 

the 

plot  data  base. 

AIS . KERNEL. ADEGRAPH 

.DATA  - 

This  is  the  data 

for 

initializing  the 

ADE  graphics  in  the  design  data  base.  (SEQ) 


AIS . KERNEL. FORMSPEC . DATA  -  This  is  the  data  for  initializing 

forms  in  the  design  and  library  model  data 
bases.  (SEQ) 

AIS . KERNEL. GRAPHICS . DATA  -  This  is  the  data  for  initializing  Pro¬ 
cess  Primitive  graphics  in  the  design  and 
library  model  data  bases.  (SEQ) 

AIS . KERNEL. SYMBOL. DATA  -  This  is  the  data  for  initializing  the 

ADE  symbol  forms  in  the  design  data  base. 
(SEQ) 

AIS . SYSGEN. CLIST  -  These  CLISTS  are  used  to  compile  and  link 

the  AISIM  system.  (PDS) 

AIS . SYSGEN. LINK. CNTL  -  These  files  are  data  used  by  the 

AIS.  SYSGEN.  CLISTs  in  performing  links.  (Pnc=' 

ADBMS. SLIB . ASM  -  These  are  the  ADBMS  assembly  languaqe  rou¬ 

tines.  (PDS) 

AIS .  IOLIB  .  ASM  __  These  are  the  assembly  language 

input/output  routines.  (PDS) 


ADBMS. DBLIB. FORT 


-  These  are  the  ADBMS  user  and  internal  rou¬ 
tines.  (PDS) 


ADBMS. FLIB . FORT 

-  These  are  the  ADBMS  utility  routines.  (PDS) 

AIS . ADEDBL. FORT 

-  These  are  the  ADE  data  base  access  rou¬ 
tines.  (PDS) 

AIS . ADELIB . FORT 

-  These  are  the  ADE  top  level  routines.  (PDS) 

AIS. ANLDBLIB. FORT 

-  These  are  the  Analyze  and  Replot  data  base 
access  routines.  (PDS) 

AIS. AUILIB. FORT 

-  These  are  the  Analysis  User  Interface  rou¬ 
tines.  (PDS) 

AIS. CLILIB. FORT 

-  These  are  the  Command  Language  Interface 
routines.  (PDS) 

AIS. COXLAT. FORT 

-  These  are  the  Fortran  Checkout  Function 
routines.  (PDS) 

AIS. DBDLIB. FORT 

-  This  contains  the  utility  ntines  for  ini¬ 

tializing  data  bases  and  th-  DBMS  common 
block.  (PDS) 

AIS. DBLIB. FORT 

-  These  are  the  Design  data  ;e  access  rou¬ 

tines.  (PDS) 

AIS. DUILIB. FORT 

-  These  are  the  top  level  De^.gn  User  Inter¬ 
face  routines.  (PDS) 

AIS. FAST. FORT 

-  These  routines  buffer  data  to  and  from  the 
terminal  to  speed  graphics.  (PDS) 

AIS. HCLIB. FORT 

-  These  are  the  routines  for  the  Hardcopy 
Graphics  Function.  (PDS) 

AIS. HPLIB. FORT 

-  These  routines  control  the  HP  terminal. 

(PDS) 

AIS. IN ITDB . FORT 

-  These  routines  are  used  to  generate  new 
initialized  data  bases.  (PDS) 

AIS. IOLIB . FORT 

-  These  routines  perform  data  I/O  between 
AISIM  and  the  host  system  commun icat ions . 

(PDS) 

AIS. LI3USIF. FORT 

-  These  are  the  routines  for  the  Library  User 
Interface.  (PDS) 

AIS. LPTLIB. FORT 

-  These  routines  are  used  in  the  generation 
of  a  iegai  path  table.  (PDS) 

AIS. MOXLAT. FORT 

-  These  are  the  Fortran  Mergeout  Function 
routines.  (PDS) 
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AIS . OFDLIB . FORT  -  These  are  the  routines  for  the  Process  Edi¬ 

tor  Interface.  (PDS) 

AIS . PLOTFLIB . FORT  -  These  are  the  routines  for  the  Replot  Func¬ 
tion.  (PDS) 

AIS . PLOTL. FORT  -  These  routines  are  used  to  draw  linear 

graphics.  (PDS) 

AIS . TTYAUI . FORT  -  These  are  Analysis  support  routines.  (PDS) 

AIS. XLATLIB . FORT  -  These  are  the  Translator  routines.  (PDS) 

AIS . CHECKIN . DATA  -  These  are  the  Simscript  routines  for  the 

Checkin  Function.  (PDS) 

AIS. MERGEIN. DATA  -  These  are  the  Simscript  routines  for  the 

Mergein  Function.  (PDS) 

AIS. SIMLATOR. DATA  -  These  are  the  Simscript  routines  for  the 

Analyze  Function.  (PDS) 

CRKSR1 . CNTL  -  This  is  the  JCL  file  for  dumping  all  of  the 

above  files  to  disk. 


Tape  AISEX1; 

AIS . LIBUTIL. LOAD  -  This  the  load  module  for  the  Library  Func¬ 
tion.  (PDS) 

AIS. SYSTEM . LOAD  -  This  is  the  load  module  for  the  rest  of  the 

ATS IM  system.  (PDS) 

AIS . CONTRL. CLIST  -  These  are  the  CLxSTS  which  control  the  exe¬ 
cution  of  AIS IM .  (PDS) 

AIS . USER . CLIST  -  This  is  the  CLIST  which  is  placed  on  the 

user's  ID  to  enable  access  to  the  AISIM  sys¬ 
tem.  (PDS) 

AIS. MESSAGES. TEXT  -  This  contains  text  messages  which  can  be 

displayed  at  the  start  of  an  AISIM  session. 
(PDS) 

AIS . VERSION. TEXT  -  This  contains  text  messages  which  can  be 

displayed  for  a  specific  version  of  AISIM. 
(PDS) 

A  IS . STARTDB . DBT  -  This  is  the  initialized  data  base  table  for 

the  Design  Function.  (SEQ) 
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AIS . MODEL. STARTDB . DBT  -  This  is  the  initialized  data  base  table 

for  the  Library  Function.  (SEQ) 

AIS. PLOT. START. DBT  -  This  is  the  initialized  data  base  table  for 

the  Replot  Function.  (PDS) 


AIS . STARTDB . DBF  -  This  is  the  initialized  start  data  base  for 

the  Design  Function.  (SEQ) 

AIS .MODEL. STARTDB .DBF  -  This  is  the  initialized  start  data  base 

for  the  Library  Function 

AIS . PLOT. STARTDB . DBF  -  This  is  the  initialized  start  data  base 

for  the  Analyze  Function.  (SEQ) 

AIS . SYSTEM . LIBRARY. DBF  -  This  is  the  initialized  start  data  base 

for  the  System  library  for  the  Library  Func¬ 
tion.  (SEQ) 

TESTDB 1 . DBF  -  This  is  a  data  base  to  be  used  in  the 

Installation  Test  Plans  and  Procedures.  (SEQ) 

TESTDBA. DBF  -  This  is  a  data  base  to  be  used  in  the 

Installation  Test  Plans  and  Procedures.  (SEQ) 

TESTDBB. DBF  -  This  is  a  data  base  to  be  used  in  the 

Installation  Test  Plans  and  Procedures.  (SEQ) 

TESTDBC . DBF  -  This  is  a  data  base  to  be  used  in  the 

Installation  Test  Plans  and  Procedures.  (SEQ) 

TESTDBD. DBF  -  This  is  a  data  base  to  be  used  in  the 

T-stallation  Test  Plans  and  Procedures.  (SEQ) 

TESTDBE.DBF  -  This  is  a  data  bse  to  be  used  in  the 

Installation  Test  Plans  and  Procedures.  (SEQ) 

CRKEX1.CNTL  -  This  is  a  JCL  fixe  to  dump  ail  of  the  above 

fixe  to  disk.  (SEQ) 

Appendix  A  shows  the  JCL  which  was  used  to  place  the  files  on  the 

tape  and  read  the  fixes  from  the  tape. 


Buixdinq  AISIM 


2.4.1  General  Information  About  Host  System  Requirements 
Fonowing  is  a  list  of  conditions  which  must  exist  on  the  host 
system  in  order  for  AISIM  to  be  executable. 


-  The  host  system  must  alxow  a  terminal  transmission  length  of 
at  xeast  620  bytes  in  order  to  accommodate  the  largest  form 
displayed  by  AISIM. 


-  The  ASCII  to  EBCDIC  translation  table  in 

AIS. IOLIB. ASM ( anyo ut )  must  generate  EBCDIC  code  which  is 

compatible  with  what  the  host  system  expects. 

-  The  terminal  line  size  must  be  at  least  80  characters  per 

line  to  accommodate  Fortran  read  statements  in  the 

AIS. CLILIB. FORT  E  .tines. 

2.4.2  Executing  Existing  Load  Modules  A  user  who  has  an  IBM 
370/VMS  EXTENDED  TSO  machine  available  and  who  wants  to  get  AISIM 
up  as  quickly  as  possible  can  do  so  by  simply  executing  the  1  -ad 
modules  ioaded  from  the  tape.  It  will  not  be  necessary  to  bring 
up  the  system  from  scratch. 

In  order  to  execute  AISIM,  the  user  will  need  the  load  modules 
for  the  system  and  the  controlling  CLISTS  (i.e.  everything  read 
from  tape  AISEX1).  The  necessary  load  modules  are  all  in  the 
PDS's  ais. system. load  and  ais . 1 ibut i 1 . load .  The  data  bases  are 
ais.startdb.dbf ,  a  is .model .star tdb.dbf ,  ais. plot. startdb. dbf ,  and 
a  is. system. 1 ibrary .dbf .  These  data  bases  are  already  initialized 
and  ready  to  be  used  to  create  a  user's  data  bases,  when  a  user 
invokes  AISIM  and  does  not  have  an  existing  data  base,  a  copy  is 
made  of  the  AISIM  start  data  base.  These  start  data  bases  should 
never  be  used  as  a  user's  data  base. 

Before  the  system  can  be  executed,  the  execution  CLISTS  will  have 
to  be  modified  slightly.  The  file  a  is . user . c 1 ist ( a  i  s)  is  the  top 
ievei  CLIST  used  to  execute  AISIM.  This  file  calls  the 
ais.contrl  CLISTS  which  actually  control  the  execution  of  AISIM. 
The  a  is .user .ci ist ( a  is)  and  the  files  in  a  is .contr 1 .cl i st  will 
have  to  be  altered  to  access  the  catalog  where  the  AISIM  files 
are  stored.  Most  of  these  files  are  currently  set  to  execute  off 
the  account  'TF01508';  they  should  be  changed  to  reference  the 
account  where  the  AISEX1  tape  has  been  dumped. 

2.4.3  Building  AISIM  From  Scratch  If  the  user  determines  that 
the  operating  system  of  the  target  host  machine  is  not  exactly 
compatible  with  IBM/MVS  EXTENDED  TSO,  then  bringing  up  AISIM  will 
involve  a  bit  more  work.  The  amount  of  work  necessary  win 
depend  on  the  extent  of  the  incompatibilities.  The  following 
steps  will  outline  what  is  necessary  to  bring  up  AISIM  completely 
from  scratch  and  the  user  will  have  to  decide  if  some  of  these 
steps  are  unnecessary  or  if  the  entire  system  must  be  rebuilt. 

2. 4. 3.1  Modi fying  Assembly  Language  Routines  AISIM  contains  two 
data  sets  of  assembly  language  routines:  a  is. ioi ib.asm  and 
adbms .si ib .asm .  These  routines  are  highly  system  dependent  and 
thus  win  probably  have  to  be  rewritten.  These  can  be  used  as  a 
guide  to  what  the  routines  must  do,  but  host  compatible  routines 
must  be  created. 
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2. 4. 3. 2  Altering  The  CLISTS  First  of  all,  the  CLISTS  must  be 
altered.  Inese  CLISTS  include  the  ais.user.clist, 
a  is .contrl .ci ist ,  and  ais.sysgen.clist  data  sets.  If  these 
CLISTS  are  completely  unusable  in  their  present  form,  the  user 
can  use  them  as  a  guide  in  writing  his  own  CLISTS.  If  they  can 
be  executed  as  is,  then  only  some  minor  modifications  will  be 
necessary.  The  ais.user.clist  and  ais. contrl .cl ist  data  sets 
which  are  used  to  execute  the  system  must  be  modified  as  outlined 
in  section  2.4.2.  The  files  in  the  ais.sysgen.clist  data  set  are 
used  to  compile  the  source  files  and  iink  load  the  modules.  All 
of  the  files  in  this  data  set  will  also  have  to  be  modified  as  in 
section  2.4.2  to  reference  the  correct  account.  These  files  also 
usuany  access  the  account  'TF015081.  In  the  CLISTS,  any  data 
set  which  is  referenced  without  single  quotes  around  its  name  is 
assumed  to  reside  in  the  user's  own  area.  Ali  data  sets  whose 
names  are  enclosed  in  single  quotes  reference  data  sets  residing 
in  the  catalog  whose  name  is  the  portion  of  the  name  up  to  the 
first  period.  For  example  the  data  set  ' sysl. fortlb2 '  references 
the  data  set  fortlb2  in  the  catalog  'sysl'.  All  data  sets  refer¬ 
enced  in  the  CLISTS  whose  names  are  enclosed  in  quotes  but  which 
are  not  referenced  as  'Suser'  or  'TF01508'  are  system  utilities 
on  the  user's  system.  The  following  is  a  list  of  the  non-user 
data  sets  referenced  in  the  CLISTS  and  a  brief  description  of 
each . 


sysl.fortib2  -  The£>e  are  the  system  FORTRAN 

utility  routines. 

scin.tcs2iib  -  These  are  the  PLOTIO  utility 

routines. 

scin.simiib8  -  These  are  the  Simscript  system 

utility  routines. 

2.4. 3. 3  Compi 1 ing  AISIM  The  second  step  is  to  compile  the 
source  fires.  Each  of  the  source  data  sets  has  a  correspondir g 
CLIST  to  compile  the  routines  in  the  data  set.  Ail  routines  in 
each  data  set  should  be  compiled.  The  following  is  a  list  of 
which  CLIST  is  used  to  compile  which  data  set.  Ali  of  the  CLISTS 
are  in  the  partitioned  data  set  ais.sysgen.clist  so  only  the 
member  name  will  be  listed. 

2. 4. 3. 3.1  FORTRAN  Subroutines  The  following  are  the  FORTRAN 
subroutines  and  the  CLISTS  used  to  compile  them  and  put  the 
object  code  into  load  libraries. 

a  is .adbdbi . for t  -  adbdbl 

adbms .dbi ib. fort  -  adbmsdb 

a i s .adbmsi ib . f o r t  -  adbmsiib 

a  is  .adedbi .  fort  -  adedbi 
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ais.adeiib.fort  -  adeiib 
ais.anldblib.fort  -  anldbiib 
ais.auilib.fort  -  auilib 
ais.clilib.fort  -  ciilib 
a  is .coxlat . f or t  -  coxiat 
ais. dblib. fort  -  dblib 
ais .duii ib. f or t  -  duilib 
ais. fast. fort  -  fast 
adbms.flib.fort  -  fiib 
ais. hclib. fort  -  hclib 
ais. hpiib. fort  -  hplib 
ais . ioi ib. for t  -  ioiib 
ais.ioiib.asm  -  iolibasm 
ais. i ibusif. fort  -  libusif 
ais. lptlib. fort  -  lptlib 
a  is .moxiat . for t  -  moxlat 
a  is  .ofdi ib. for t  -  ofdiib 
ais. piotfl ib. fort  -  plotflib 
a  is  .pioti . fort  -  plotl 
adbms .si ib.asm  -  siib 
ais.ttyaui . for t  -  ttyaui 
a  is.xiati ib. fort  -  xlatiib 

Ai  i  of  the  above  compile  CLI3TS  are  executed  by  using  the  follow 

ing  command: 

ex  a  is .sysg en .cl  is t ( abo ye  CLIST)  'routine  name' 

2. 4. 3. 3. 2  Common  Block  The  ADBMS  common  block  must  aiso  be  com 

piled.  It  is  compiled  using  the  following  command: 


ex  ais.sysgen.ci ist (dbblk) 

2. 4. 3. 3. 3  Utilities  The  routines  which  are  used  to  create  ai 
ADBMS  data  base  and  initialize  that  data  base  with  AISIM  forms 
and  graphics  data  must  also  be  compiled.  These  CLISTS  which  com¬ 
pile  the  necessary  routines  are  iisted  and  described  below: 


mddia  -  compile  the  program  which  creates  a  blank  ADBMS 
data  base. 


mdbin 


-  compile  the  program  which  initializes  an  ADBMS 
data  base  with  necessary  ADBMS  data. 


mdbdmain  -  compile  the  program  which  initializes  an  ADBMS 

data  base  with  AISIM  forms  and  graphics  data  for  a 
design  data  base. 


mdbimain  -  compile  the  program  which  initializes  an  ADBMS 

data  base  with  AISIM  forms  and  graphics  data  for  a 
library  model  data  base. 


dbdiib  -  compile  the  subroutines  which  are  used  by  the 
dbdmain  and  the  dblmain  programs. 


The  first  four  CLISTS  are  executed  using  the  following  command: 

ex  ais.sysgen.ci ist (above  CLIST) 

The  last  CLIST  is  executed  with  the  following  command: 


ex  ais .sysgen .cl ist (dbdi ib)  'routine' 

where  routine  is  the  name  of  the  routine  in  ais. dbdiib. fort  which 
is  to  be  compiled.  All  routines  in  this  data  set  should  be  com¬ 
piled. 

2. 4. 3. 3. 4  Mains  Ail  of  the  AISIM  main  programs  must  also  be 
compiled.  The  Flies  to  execute  are  the  following: 


auima  in 

-  compile 

the 

Analyze 

Function  main 

check  i  n 

-  compile 

the 

Check i n 

Function  main 

d  u  ima  i  n 

-  compile 

the 

Design 

Function  main 

hcma  i  n 

-  compile 

the 

Hardcopy  Function  main 

mergein 

-  compile 

the 

Mergein 

Function  main 

piotma  in 

-  compile 

the 

Replot 

Function  main 

x l atna  i  n 

-  compile 

the 

Translator  main 
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These  CLISTS  are  executed  using  the  following  command: 
ex  ais.sysgen.clist (above  CLIST) 

2. 4. 3. 4  Linking  The  Load  Modules  After  all  of  the  files  have 
been  compiled,  the  next  step  is  to  link  all  of  the  load  modules. 
The  following  CLISTS  are  used  to  link  the  various  modules: 

sinkddla  -  link  the  program  which  creates  an  emply  ADBMS 
data  base. 

slnkdbin  -  link  the  program  which  initializes  an  ADBMS  data 
base . 

siinkdbd  -  link  the  program  which  initializes  an  AISIM  data 
base  with  the  forms  and  graphics  data  for  a  design 
data  base. 

slinkdbl  -  link  the  program  which  initializes  an  AISIM  data 
base  with  the  forms  and  graphics  data  for  a  library 
model  data  base. 

siinkaui  -  link  the  Analyze  Function, 

siinkci  -  link  the  Checkin  Function. 

siinkcos  -  link  the  Checkout  Function  selection  interface, 

siinkcox  -  link  the  Checkout  Function  translator, 

siinkdui  -  link  the  Design  Function, 

siinkhc  -  link  the  Hardcopy  Graphics  Function, 

slinkmi  -  link  the  Mergein  Function. 

siinkmos  -  link  the  Mergeout  Function  selection  interface, 

siinkmox  -  link  the  Mergeout  Function  translator, 

siinkpci  -  link  the  precheckin  interface, 
siinkpit  -  link  the  Replot  Function, 

siinkx  -  link  the  Translator. 

The  CLISTS  siinkaui,  siinkdui,  siinkhc,  siinkpit,  and  siinkx  are 
executed  using  the  following  command: 

ex  a  is .sysgen .c 1 ist ( above  CLIST)  'version' 

where  version  is  the  number  of  the  version  to  be  linked.  Ai i  of 
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the  other  CLISTS  are  executed  as  above,  but  without  the  version. 

2. 4. 3. 5  Build  The  Start  Data  Bases  After  all  of  the  load 
modules  have  been  built,  the  next  step  is  to  build  the  AISIM 
start  data  bases.  The  CLIST  members  which  build  the  necessary 
data  bases  are  the  following: 

allocdbd  -  build  the  Design  start  data  base: 

a is.startdb.dbf  and  ais .startdb.dbt. 

ailocdbi  -  build  the  Library  model  start  data  base: 

ais. model .startdb.dbf  and  ais. modei. startdb.dbt. 

aiiocplt  -  build  the  Replot  start  data  base: 

ais. plot. startdb.dbf  and  ais. plot. startdb.dbt 

These  CLISTS  are  executed  using  the  following  command: 

ex  ais. sysgen. cl ist (above  CLIST) 

2.4. 3.6  Test  The  System  After  the  data  bases  have  been  built, 
the  user  is  ready  to  execute  AISIM.  Assuming  the  CLISTS  have 
been  set  up  as  described  in  section  2.4.2,  the  user  should  be 
able  to  invoke  AISIM  by  entering  the  command  AISIM.  The  operation 
of  AISIM  should  then  be  verified  using  the  procedures  in  this 
manual . 
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3.  INSTALLATION  TESTING 

3. 1  Test  Descriptions 

Installation  testing  of  AISIM  consists  of  verifying  that  ail  the 
components  of  the  system  work  together  properly.  Figure  1  shows 
an  these  components  and  their  relationships  to  one  another. 

Five  tests  will  be  performed,  each  exercising  one  of  the  user 
interfaces  and  all  of  the  components  related  to  it. 

3.1.1  Design  User  Interface  Test  Description  The  Design  User 
Interface  is  used  to  create  AISIM  models.  This  includes  the 
model  entity  definition  which  is  performed  under  the  Design  User 
Interface,  as  well  as  the  subordinate  functions  of  the  Process 
Editor  Interface  which  is  used  to  construct  Processes,  and  the 
Architecture  Design  Editor  which  is  used  to  specify  a  system 
architecture  and  its  message  routing  characteristics.  Test  Pro¬ 
cedure  3.4.1  is  designed  to  show  that  the  following  capabilities 
are  available: 

-  Create  entities 

-  Copy  entities 

-  Modify  entities 

-  List  entities 

-  Delete  entities 

-  Save  model  data  bases 

-  Add  Process  Primitives 

-  Change  Process  Primitives 

-  Delete  Process  Primitives 

-  Display  various  portion  of  Processes 

-  Creation  of  an  architecture  -  placement  of  symbols  and  con¬ 
nections 

-  Definition  of  Resource  attributes  through  symbol  prototyping 

-  Movement  of  symbols  and  connections  within  architecture 

-  Windowing  in  architecture  work  space 

-  Creation  of  LPT  both  manually  and  automat ical iy 
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3.1.2  Analysis  User  Interface  Test  Description  The  Analysis 
User  Interface  is  used  to  run  simulations  of  AISIM  models.  Test 
Procedure  3.4.2  is  intended  to  show  that  the  following  capabili¬ 
ties  are  available: 

-  Translate  models 

-  List  certain  entities 

-  Display  certain  entity  statistics 

-  Modify  certain  entity  values 

-  Establish  breakpoints 

-  Cancel  breakpoints 

-  Define  plots 

-  Display  plots 

-  Save  plot  sets  (definitions  or  data) 

-  List  saved  plot  sets 

-  Retrieve  saved  plot  definition  sets 

-  Run  simulations 

3.1.3  Replot  User  Interface  Test  Description  The  Replot  User 
Interface  is  used  to  plot  selected  simulation  results.  Test  Pro¬ 
cedure  3.4.3  is  designed  to  verify  that  the  following  capabili¬ 
ties  are  available: 

-  List  saved  plot  sets  (definitions  or  data) 

-  Retrieve  saved  plot  data  sets 

-  Display  plots 

-  Delete  saved  plot  sets 

3.1.4  Hardcopy  User  Interface  Test  Description  The  Hardcopy 
User  Interface  is  used  to  document  the  graphical  description  of 
model  Processes.  Processes  can  be  plotted  individually  or  all 
Processes  :n  a  model  can  be  plotted.  Test  Procedure  3.4.4  is 
designed  to  verify  that  the  following  capabilities  are  available: 

-  User  can  specify  paper  size 

-  User  can  plot  individual  Processes 
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-  User  can  plot  all  model  Processes 

3.1.5  Library  User  Interface  Test  Description  The  Library  User 
Interface  is  used  to  access  the  four  functions  of  the  Library 
Function.  The  Library  Function  is  used  to  check  models  into  ?nd 
out  of  a  user's  library  or  the  system  library,  and  to  merge  parts 
of  libraries  into  and  out  of  a  user's  data  base.  Test  procedire 

3.4.5  is  designed  to  verify  that  the  following  capabilities  are 
available: 

-  List  the  models  in  a  library. 

-  List  the  contents  of  a  specific  library. 

-  Check  a  model  out  of  a  library. 

-  Merge  in  a  model  without  conflicts. 

-  Resoive  naming  conflicts  in  a  model  to  be  merged  into  a  data 
base . 

-  List  entities  in  a  data  base. 


-  Select  entities  to  be  merged  out. 

-  Check  a  model  into  a  library 

-  Delete  a  model  from  a  library. 


3.2  Test  Equipment 


Installation  testing  will  be  performed  on  the  version  of  AISIM 
which  is  to  be  rehosted  on  the  MITRE  Corporation  IBM  3031  com¬ 
puter  system.  This  testing  will  take  place  after  rehost  at  the 
MITRE  facility.  MITRE  must  provide  the  following  equipment  for 
this  testing: 


*  1  HP2647A  graphics  terminal 


♦  1  HP26  31G  printer  plotter  connected  to  terminal  with  HPIB 
inter  face 


*  connection  to  computer  system 
3 . 3  Test  Conditions 

An  input  data  will  be  entered  by  the  tester  in  interactive  mode. 
The  specific  inputs  are  listed  in  Section  3.4.  No  other  test 
conditions  apply  to  this  test  pian. 
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3.4  Test  Procedures 


The  test  procedures  are  presented  in  tabular  form.  Each  includes 
a  list  of  the  functions  to  be  performed,  user  commands  and 
responses  to  perform  the  function,  expected  results  of  each  com¬ 
mand  and  function,  and  an  area  for  recording  the  test  results. 

3.4.1  Design  User  Interface  Test  Procedure  This  test  exercises 
the  commands  available  in  the  Design  User  Interface.  The  test  is 
structured  such  that  results  of  functions  which  are  not  directly 
observable  are  verified  as  part  of  the  test.  For  example,  when  a 
node  is  placed  in  the  architecture  with  predefined  Resource 
attributes,  the  presence  of  these  attributes  is  verified  iater  in 
the  test. 
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FUNCTION/COMMANDS 

1.  Initiate  an  AISIM 
session 

EX  AISIM 


2.  Invoke  Design  User 
Inter  face 

d  p( intgtest) 


3,  Edit  one  of  each 
of  the  following 
entity  types. 

e  r , restest ,new 
e  i , i temtest ,new 
e  t , tabi test , new 
e  a ,acttest ,new 
e  v ,vartest ,new 
e  c, contest, new 
e  q , quetest ,new 
e  i , loadtest ,new 

4.  e  s,scentest 


5.  e,  p , proc test , new 


<3 .  menu 


7.  Piace  one  of  each 
Pr im i t i ve  type . 


ADDITIONAL  INPUTS/  TEST  RESULTS 

EXPECTED  RESULTS 


AISIM  Executive  Messages 
are  displayed.  AISIM 
READY  prompt  is  displayed, 
d isplayed . 


DUI  messages  displayed. 
Copy  data  base  prompt 
displayed.  User  enters 
"yes".  Data  base  is  cop¬ 
ied.  "*"  prompt  is  dis¬ 
played  . 


Appropriate  entity  form 
is  displayed.  User  enters 
random  data  into  forms 
and  enters  them. 
prompt  is  displayed. 


Message  is  displayed  in¬ 
dicating  that  "scentest" 
does  not  exist  and  the 
user  is  asked  if  (s)he 
wishes  to  create  it. 

User  enters  "yes"  and 
test  proceeds  as  in  3 
above . 

Process  form  is  displayed. 
User  enters  random  data 
into  form  and  enters  it. 
prompt  is  displayed. 

The  menu  of  Primitive 
symbols  is  displayed. 
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p  action 
p  alloc 
p  assign 
p  branch 
p  call 
p  create 
p  compare 
p  deailoc 
p  destroy 
p  entry 
p  evai 
p  file 
p  find 
p  lock 
p  loop 
p  prob 
p  reset 
p  remove 
p  resume 
p  send 
p  suspend 
p  test 
p  trace 
p  unlock 
p  wait 

8.  Change  selected 

Process  Primitives. 

c  1 
c  2 
c  3 
c  4 
c  5 
c  6 


9.  Dispray  portions  of 
Process  moving  both 
up  and  down. 

tottom 
u  1  3 
c  5 
top 


10.  Delete  selected 


Each  Primitive  form  is 
displayed.  User  enters 
mi  seel laneous  data  and 
enters  form.  prompt 

is  displayed.  User 
issues  next  PLACE  command. 


Change  primitives  shown 
on  first  page  of  Process. 
In  response  to  change 
command,  specified  Primi¬ 
tive  form  is  displayed 
with  existing  information. 
User  changes  information 
as  desired  and  enters 
form.  System  responds  by 
redrawing  Primitive  and 
displaying  "#"  prompt, 
prompt. 


User  enters  combination 
of  movement  commands. 

After  each  command,  screen 
is  erased  and  new  portion 
of  Process  is  displayed. 

prompt  is  redisplayed. 
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Process  Primitives 


del  5 
del  2,2 
del  13 


11.  Exit  the  Process  Editor, 
end 


12.  Copy  one  of  each 
entity  type. 

copy  r , r estest , res2 
copy  i , l temtest , i tm2 
copy  t , tabl test , tabi 2 
copy  a,acttest,act2 
copy  v,vartest,var2 
copy  c , contest ,con2 
copy  q,quetast,q2 
copy  i , xoadtest , ioad2 
copy  s .scentest ,scen2 
copy  p ,proctest ,proc2 

13.  Verify  that  Copy 
commands  worked. 

list  r 
list  i 
list  t 
list  a 
list  v 
list  c 
list  q 
list  i 
list  s 
list  p 

14.  Deiete  original  of  each 
entity  type. 

dei  r,restest 
dei  i , i temtest 
dei  t , tabi test 


Randomly  select  Primitives 
to  be  deleted.  In  re¬ 
sponse,  the  selected  Pri¬ 
mitive  and  those  displayed 
below  it  are  erased.  Pri¬ 
mitives  below  one  selected 
are  redrawn.  "#“  prompt 
displayed.  Note  that  Pri¬ 
mitives  may  only  be  de¬ 
leted  if  presently  shown 
on  the  screen. 


Screen  is  cleared  and 

prompt  is  displayed. 


User  enters  list  of  com¬ 
mands,  one  at  a  time. 
After  each  command, 
prompt  is  redisplayed. 


Appropriate  entity  list 
(original  entities  and 
copies).  prompt  is 

redisplayed  after  each 
command . 


After  each  command,  system 
performs  processing  and 
returns  prompt. 
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del  a,acttest 
del  v,vartest 
del  c, contest 
del  q,quetest 
del  l,loadtest 
del  s,scentest 
del  p,proctest 

15.  List  each  entity 
type . 

list  r 
list  i 
list  t 
list  a 
list  v 
list  c 
list  q 
list  1 
list  s 
list  p 

16.  Save  the  data  base, 
save 


17.  Delete  existing 

Resources  and  verify. 
Create  new  Resource. 

del  rf* 
list  r 

e  r, archtest 


Appropriate  entity  list 
(copied  entities  only). 

prompt  redisplayed 
after  each  command. 


Console  beeps  5  times, 
prompt  is  returned. 


Processing  performed  and 
prompt  returned.  User 
lists  Resources  to  verify 
that  all  are  deleted. 
System  provides  null  list 
and  returns  n*n  prompt. 
User  enters  new  Resource, 
filling  in  Resource  form 
and  filling  attribute  form 
with  miscellaneous  infor¬ 
mation. 


IS.  Edit  an  a rch i tectur e . 
a 


19.  Definition  of  symbol/ 
Resource  prototypes  for 
various  symbols. 


Screen  is  cleared.  Archi¬ 
tecture  grid  is  drawn. 

"#"  prompt  is  provided. 
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def  sqr, archtest 

def  bus 

def  crd 

def  dia 

def  drm 

def  dsk 

def  rod 

def  pig 

def  prp 

def  ptr 

def  rec 

def  tap 

def  tri 

def  tty 


After  processing  each  com¬ 
mand.  The  system  returns 
3  "I"  prompt.  The  user 
should  note  that  the  form 
displayed  is  the  same  that 
was  entered  for  the  Re¬ 
source  archtest.  After 
the  user  enters  each  com¬ 
mand,  the  system  displays 
the  form  for  the  specified 
symbol.  The  user  should 
enter  miscellaneous  infor¬ 
mation  into  this  form, 
being  sure  to  enter  "YES" 
in  the  "attributes  fieid". 
After  entering  this  form, 
an  attribute  form  will  be 
displayed.  The  user  enters 
miscellaneous  information 
into  this  form  and  enters 
it.  The  "#"  prompt  is  re¬ 
turned  . 


20.  Placement  of  symbols 
and  connections. 

p  sqr, AA, 20, 20 
p  tr i , 98 , 40 , 40 
p  rod  , CC ,  *50 , 60 
con  AA,CC,conl 
con  AA, BB , con2 . F 

21.  Move  a  symbol 
within  the  archi¬ 
tecture. 

move  AA, 30 , 30 


22.  Redraw  a  connec¬ 
tion  within  the 
a  rch i tec tur e  . 

recon  con3.F 


23.  Window  view  space 
over  work  space. 


Starting  with  these  com¬ 
mands,  create  an  archi¬ 
tecture. 


Symbol  is 
redrawn  at 
Connection 
"#"  prompt 


rased  and 
new  locatio 
is  replaced 
is  returned 


n. 


Connection  is  erased  and 
graphics  cursor  is  dis¬ 
played  to  user.  Enter 
the  connection  again. 
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l 

win  d,20 

1 

Issue  various  window  com- 

win  u,10 

mands  as  shown  at  left. 

win  r,30 

After  each  command  screen 

win  1,20 

is  erased  and  redrawn  at 

win  r,20,u,10 

new  location.  "#"  prompt 

win  l,10,d,30 

is  returned. 

24.  Manipulate  LPT  functions. 

1 

list  lpt 

: 

1 

( 

LPT  is  listed  in  alpha 
memory  of  terminal.  LPT 
should  represent  point- 
wise  connection  of  adja¬ 
cent  nodes.  "#"  prompt 
is  returned. 

,  list  path , AA, BB 

Should  provide  path  only 

l  list  path,BBrCC 

when  adjacent  nodes  are 
specified.  System  res¬ 
ponds  with  "NO  SUCH  PATH" 
for  nonadjacent  nodes. 

"#"  prompt  is  displayed. 

def  path ,BB,CC,con2. 

F,conl  User  defines  a  path  through 
several  nodes.  System  pro¬ 
cesses  command  and  displays 
"#"  prompt. 

\  list  path , BB , CC 

fej 

(' 

i- 

"From  node"  and  "To  node" 
should  be  the  same  nodes 
as  used  in  processing  com- 

1 

mand .  Path  just  entered 
and  all  subpaths  are  dis¬ 
played.  M"  prompt  is  re¬ 
turned  . 

:  1 

list  lpt 

LPT  as  above  is  listed  but 
with  defined  path  added. 

1 

"#"  prompt  returned. 

del , path  ,  BB  ,  CC 

S 

Use  "from  node"  and  "to 
node"  as  above.  System 
processes  command.  Returns 
prompt . 

list  pa th , BB , CC 

| 

Use  "from  node"  and  "to 

node”  as  above.  System 
responds  with  "NO  SUCH 

PATH".  Returns  prompt. 

* 

prompt . 

list  lpt 

j 

'  t 

LPT  is  listed  as  in  last 

list  lpt  command  execpt 

Page  25 

-H 

I 


deleted  path  is  gone. 

"#"  prompt  is  displayed. 


25.  Change  node  and 

connection  parameters. 

chg  name, CC, XX 


list  lpt 


chg  size,BB,4 
list  lpt 
chg  type,AA.tty 
list  lpt 


chg  name , Con  1 , Conx 
list  ipt 


25.  Save  data  base  while 
in  architecture. 

save 


27.  End  architecture 
session . 

end 


28.  Verify  LPT  algorithm 
operat ion . 

i  n  fo 


end 


Node  name  is  changed  on 
screen.  prompt  re¬ 

turned  . 

Note  change  to  new  node 
name  in  LPT.  prompt 

returned  after  listing 
of  LPT. 

Appropriate  changes  made. 
After  each  command,  list 
LPT  and  verify  no  change 
to  LPT.  "#"  prompt  dis¬ 
played  after  each  command 
in  this  sequence. 

Connection  name  is  changed. 
List  LPT  to  verify  correct 
LPT  change.  "#"  displayed 
after  each  command. 


Console  beeps  5  times. 
"*"  prompt  displayed. 


Screen  is  cleared.  LPT 
message  prompts  are  output. 
"#"  prompt  displayed. 


Messages  output  describing 
LPT  algorithms.  prompt 

returned . 

No  LPT  processing  done. 

prompt  displayed.  User 
should  reenter  a rch i tecture , 
list  ipt,  and  verify  that 
no  change  has  occurred. 

User  then  ends  architecture 
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b 


c 


29.  Verify  architecture 
nodes  are  represented 
in  .List  of  Resources. 

i  ist  r 


e  r ,  AA 

(representing  tty 
in  architecture) 


30.  Reenter  Architecture 
a 


31.  Dexete  architecture 
nodes  and  connections 


session  again  and  uses  next 
input  as  response  to  LPT 
generator  prompt. 

LPT  algorithm  A  operates. 
Control  is  passed  to  DUI. 

prompt  displayed. 

User  should  reenter  archi¬ 
tecture,  view  LPT  with 
"list  lpt"  and  verify 
against  the  architecture. 
User  then  returns  to  DUI 
session,  enters  architec- 
design  editor,  and  receives 
LPT  messages  again. 

LPT  algorithm  B  operates. 
Same  prompts  and  sequences 
should  be  reported  as  in 
previous  step. 

LPT  algorithm  C  operates. 
Same  as  previous  steps 
except  upon  reentering  DUI, 
user  performs  following 
commands . 


List  of  Resources  is  dis¬ 
played.  User  verifies  pres¬ 
ence  of  all  architecture 
node  and  channel  Resources, 
including  .A  and  .B  Resour¬ 
ces  for  .F  connections  used 
in  architecture. 

Resource  forms  presented. 
User  verifies  presence  of 
attributes  as  specified  in 
Step  19.  Repeat  for  tri¬ 
angle  symbol.  prompt 

displayed  after  entering 


Grid  redrawn.  prompt 

d i spx  ayed . 
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dei  conx 
dei  con2.F,BB 
dei  * 

32.  End  architecture 
end 

33.  End  LPT. 
end 

34.  Save  data  base  while 
in  DU I . 

save 

35.  End  DUI . 
end 


Use  various  delete  commands 
as  shown  at  left  to  verify 
use  of  each.  Appropriate 
symbols  and  connections  are 
deleted.  "#"  prompt  dis¬ 
played  after  processing  of 
each  command. 


Screen  cleared.  LPT  gen¬ 
erator  prompt  messages 
displayed.  "#"  prompt 
returned . 


prompt  returned. 


Terminal  "beeps"  5  times, 
prompt  returned. 


Data  base  save/no  save 
prompt.  User  responds 
yes  or  no  as  desired.  If 
no,  DUI  ended  and  "AISIM 
READY  prompt  is  displayed. 
If  yes,  terminal  "beeps" 

5  times  and  then  "AISIM 
READY"  is  displayed, 
displayed . 
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3.4.2  Analysis  User  Interface  Test  Procedure  The  analysis  test 
procedure  verifies  three  functions: 

1.  that  a  model  data  base  created  in  a  Design  session  can  be 
translated  by  the  Translate  Function, 

2.  that  the  translated  model  can  be  initialized  by  the  Analysis 
User  Interface,  and 

3.  that  the  Analysis  User  Interface  commands  can  be  success¬ 
fully  exercised  against  the  initialized  model. 
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FUNCTION /COMMANDS 

1.  Model  Input 

Use  Design  User 
Interface 


2.  Invoke  the  Analysis 
User  Interface  (AUI) 

a  p(testdbl) 


3.  List  each  entity  type. 

i  c 
i  r 

JL  P 

1  V 

i  q 

i  i 


ADDITIONAL  INPUTS/  TEST  RESULTS 

EXPECTED  RESULTS 


Using  the  capabilities  of 
the  DU I ,  build  a  model  des¬ 
cribed  in  Appendix  B.  Exit 
the  DUI,  saving  the  model 
data  base,  and  return  to 
the  AISIM  Ready  level. 

User  may  instead  wish  to 
use  test  data  base  Testdbl 
provided  with  the  instal¬ 
lation  tape.  This  is  the 
same  model  listed  in  Ap¬ 
pendix  B. 


AUI  messages  are  displayed. 
User  is  queried  "Yes  to 
proceed-No  to  abort".  User 
enters  "Yes".  Translation 
of  model  data  base  is  per¬ 
formed.  Model  initializa¬ 
tion  takes  place.  Prompt 
issued  "NO  ERRORS  DETECTED 
IN  MODEL  TRANSLATION  YOU 
MAY  NOW  ENTER  COMMANDS". 

"#"  prompt  is  also  dis¬ 
played  . 


Appropriate  list  of  enti¬ 
ties  is  displayed  and 
prompt  returned  after  each 
command.  Check  lists 
against  Appendix  B. 


4.  Define  Piots-user  selects 
entity  names  to  plot 

def  r, resource  name 
def  q, queue  name 
def  u, variable  name 
def  p, process  name 
def  i , i tem  name 


An  attribute  form  for  the 
selected  entity  type  is 
displayed.  Testor  selects 
attribute  and  enters  form. 
A  statistic  form  is  dis¬ 
played.  User  selects  sta¬ 
tistic  and  enters  form. 
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5.  Set  a  breakpoint 
set  r,bib2 


6.  Initiate  the  simulation, 
go 


7.  Display  selected  entity 
statistics 

iv  r,bib2 
iv  r,h2 
iv  i,msg 
iv  stream 

8.  Edit  one  of  each  legal 
entity  type 

edit  v , v .cs , . 00 1 
edit  stream ,  load  ,  7 

9.  Continue  the  simulation 

go 


10.  Display  the  piots  in 
various  combinat ions . 

plot 


#  prompt  is  displayed. 
This  step  can  be  repeated 
to  test  various  combina¬ 
tions  . 


Appropriate  entity  attri¬ 
bute  and  statistic  selec¬ 
tion  forms  are  displayed. 
User  enters  forms  and  re¬ 
ceives  prompt. 


Simulation  begins.  When 
breakpoint  reached,  simu¬ 
lation  is  halted  and  user 
is  allowed  to  enter  com¬ 
mands.  "#"  prompt  is  dis¬ 
played  . 


All  statistics  associated 
with  specified  entity  are 
displayed . 


The  screen  is  cleared  and 
the  #  prompt  is  returned. 


Simulation  continues  until 
terminated.  Message  indi¬ 
cating  normal  termination 
is  displayed.  User  is  al¬ 
lowed  to  enter  commands. 

*  prompt  displayed. 


Menu  of  plots  is  displayed 
User  selects  desired  plots 
Plots  generated  #  prompt 
displayed.  User  should  re¬ 
peat  for  vaious  piots. 
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11.  Save  piot  data  and 
definitions 

save  def,defsetl, 
def initions 
save  plot ,piotsetl , 
rum  resuits 

12.  List  the  saved  plot 

sets  and  definition  sets. 

i  piot 
i  def 


13.  Exit  Analysis  User 
Interface 

end 


14.  Reenter  AUI 

a  p(data  base  name) 

15.  Edit  selected  constants 
and  variables  to  change 
simulation  results. 

edit  v,  select  variable, 
select  value 

edit  c,  select  constant, 
select  value 

16.  Set  piot  definitions 

get  def,defsetl 


17.  Set  a  breakpoint 

set  r,b3b4 

18.  Cancel  the  breakpoint 

can 


19.  Set  infinite  resources 


Definitions  &  plots  are 
saved.  Screen  is  cleared 
after  each  command  and  *#" 
prompt  is  displayed. 


The  names  of  each  Plot  set 
and  definition  set  and 
their  descriptions  are  dis¬ 
played.  A  "*•  prompt  is 
displayed . 


Clear  screen  and  AISIM 
Ready  prompt. 


See  step  2. 


See  Step  8. 


Clear  screen  and  #  prompt 
returned . 


See  step  5. 


Breakpoint  is  cancelled. 
Clear  screen  followed  by 
new  prompt. 
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inf res 

20.  Execute  simulation 

go 

21.  Save  plot  resuits 

save  plot, plotset2, run  Plot  results  saved.  "#n 

2  results  prompt  displayed. 

22.  Exit  AUI 

end  See  step  13 

3 . 4 . 3  Replot  User  Interface  Test  Procedure  The  Replot  User 
Interface  Test  Procedure  wiil  be  used  to  test  all  Replot  commands 
and  alx  capabilities  of  the  Replot  function  as  described  in  sec- 
t ion  3.1.3 


Infinite  resources  set. 
Clear  screen  followed  by 
new  "#H  prompt. 


Simulation  executes.  Nor¬ 
mal  termination  messages 
displayed.  "#"  prompt  dis¬ 
played. 
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FUNCTION /COMMANDS 


Invoke  the  Replot 
User  Interface 

repiot  p(project  name) 


2.  List  set  types 


i  def 
i  plot 
i  title 


3.  Retrieve  each  plot  data 
set  selecting  plots  from 
each  set. 

get  plot ,piotseti 
get  piot ,piotset2 


List  titles 


i  title 


5.  Display  the  piots  in 
various  combinations 

piot 


Ciear  the  current  piots, 


Repeat  steps  3-5 
3 electing  new  piots 

Delete  a  piot  set 


ADDITIONAL  INPUTS/ 


EXPECTED  RESULTS 


TEST  RESULTS 


R^plot  messages  and  prompt 
to  continue  followed  by 
"$"  prompt. 


1  def  lists  all  plot  def¬ 
inition  sets,  1  plot  lists 
all  plot  data  sets,  1  title 
lists  current  piot  tities-- 
none  at  this  point.  "$" 
prompt  displayed. 


Plot  titles  in  each  set 
are  displayed.  User  is 
allowed  to  select  specific 
plots  which  are  put  in  the 
current  set  of  piots. 


List  of  titles  of  current 
piots.  "$"  prompt  displayed 


Current  piot  titles  are 
displayed  for  user  selec¬ 
tion.  After  selection  piot 
is  generated  and  "$"  prompt 
is  displayed. 


Current  piot  information 
is  purged.  "$"  prompt  is 
d i spi ayed . 


See  steps  3-5 
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delete  plot ,plotsetl 


Plotset  is  deleted, 
prompt  is  displayed. 


"  $  •• 


9.  Delete  a  definition  set 

delete  def,defsetl  Definition  set  is  deleted. 

"$"  prompt  is  displayed. 

10.  List  sets 

i  def 
1  plot 


11.  Exit  the  Repiot  User 
Interface. 

end  Screen  is  cleared.  AISIM 

READY  prompt  is  displayed. 


List  of  remaining  sets  of 
each  type  are  displayed 
followed  by  $  prompt. 


3.4.4  Hardcopy  User  Interface  Test  Procedure  The  Hardcopy  User 
Interface  verifies  that  the  data  interface  between  the  AISIM  sys¬ 
tem  and  the  terminal  is  operating  properly.  It  also  verifies  the 
actual  operation  of  the  AISIM  software.  It  exercises  the  func¬ 
tions  described  in  section  3.1.4. 
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FUNCTION/COMMANDS 


1.  Invoke  tne  Hardcopy  User 
Interface  -  plot  sinqle 
Process . 

hcopy  p(project  name) 


2.  Invoke  the  HUI-plot 
aii  Processes . 

hcopy  ptproject  name) 


ADDITIONAL  INPUTS/  TEST  RESULTS 

EXPECTED  RESULTS 


Hardcopy  messages  and 
prompt  to  continue.  User 
is  then  prompted  whether 
to  plot  all  Processes  or 
not.  User  enters  no.  User 
is  prompted  for  paper  size. 
User  enters  paper  size. 

User  prompted  to  position 
paper.  User  positions  pa¬ 
per.  User  prompted  for 
Processes  to  plot  one  at  a 
time.  Processes  plotted. 
Return  to  AISIM  READY  lev¬ 
el  when  user  indicates  de¬ 
sire  to  exit. 


Hardcopy  messages  and 
prompt  to  continue.  User 
is  then  prompted  whether 
to  plot  all  Processes  or 
not.  User  enters  yes. 

User  is  prompted  for  paper 
size.  User  enters  paper 
size.  User  prompted  to 
position  paper.  User  po¬ 
sitions  paper.  Processes 
plotted.  Return  to  AISIM 
Ready  level. 


3.4.5  Library  User  Interface  Test  Procedure  The  four  Library 
s ub f inc t i ons  are  Checkin,  Checkout,  Mergein,  and  Mergeout.  In 
the  following  test  procedure  all  four  of  these  functions  are 
tested.  Test  steps  associated  with  the  testing  of  Checkout  are 
proceeded  by  an  A  or  AA  (i.e.  Al,  A2,  A3,  etc.) .  Mergein  is  pre- 
ceedoc  with  a  B  (i.e.  Bl,  B2,  etc.).  Likewize  Mergeout  and  Chec¬ 
kin  are  preceeded  with  C  and  D  respectively. 
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FUNCTION /COMMANDS 


ADDITIONAL  INPUTS/ 
EXPECTED  RESULTS 


TEST  RESULTS 


Access  the  Library 
Functions 

Library 


Enter  command  at  the  AISIM 
Ready  level.  System  re¬ 
sponds  with  LIBRARY  READY. 


A  1  Invoke  the  Checkout 

Function  on  the  system 
1 ibrary . 

co  i(system)  b(testbuf) 


System  displays  verifica¬ 
tion  messages  and  prompt. 
User  types  yes.  "You  may 
now  extract  models  from  the 
library"  is  displayed  as 
well  as  prompt. 


A  2  List  ail  models  in  the 
i ibrary. 

i  * 

A  3  List  the  contents  of  a 
specific  model. 

i  commun-a 


A  4  Frag  a  model  for  being 
Checked  out 

ext  commun-a 


A  5  Exit  the  Checkout 
Function 

end 


All  models  in  system  li¬ 
brary  are  listed.  "*" 
prompt  is  displayed. 


For  every  legal  entity  type, 
all  the  entities  of  that 
type  are  displayed  followed 
by  "do  you  wish  to  continue 
listing  the  model?"  query. 
User  should  respond  yes  un¬ 
til  the  prompt  is  dis¬ 

played  after  the  Processes 
are  1  i  s ted . 


The  model  is  flagged  for 
extraction.  prompt 

d i spi ayed . 


A  message  is  displayed  when 
the  Checkout  has  been  com- 
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pieted.  The  user  is  re¬ 
turned  to  the  LIBRARY  Ready 
level . 


B  1  Invoke  the  Mergein 

Function  using  the  same 
buffer  with  an  empty 
data  base. 

mi  p(testdb)  b(testbuf) 
l ( 1 ibr ary) 


B  2  Invoke  the  Mergein 
Function  again  with 
naming  conflicts. 

mi  p(testdb)  b(testbuf) 


B  3  Resolve  the  namaing 
'  !  conflicts. 

(msg) 

f  ,  (chi  io ) 

•  (control) 

(esr-can) 

(  ihandier) 

>  (req-i/o) 

[  (router) 

(  C  i  Invoke  the  Mergeout 

!  Function  using  the  same 

buffer  and  data  base 

t 

mo  p(testdb)  b(testbuf) 


rn 

rp 

ig 

rn 

rp 

ig 

ig 


message 
chi  io 

cail-esr 


Verification  messages  and 
prompt  are  displayed.  User 
responds  yes.  User  is 
asked  if  (s)he  wants  to 
create  the  project.  User 
responds  yes.  Messages 
are  displayed  indicating 
no  naming  conflicts.  Merg- 
in  operation  completes  and 
LIBRARY  READY  prompt  is 
d isplayed . 


Verification  messages  and 
prompt  displayed.  User 
responds  yes.  This  time 
the  system  tells  the  user 
that  7  conflicts  were  de¬ 
tected  and  asks  if  the  us¬ 
er  wishes  to  resolve  these 
conflicts.  User  responds 
yes . 


User  responds  to  "option:" 
prompts  and  verification 
is  given.  Mergein  opera¬ 
tion  is  begun  as  soon  as 
all  naming  conflicts  are 
resolved . 


Verificaton  messages  and 
promr-t  displayed.  User 
en«--.s  yes.  User  prompted 


i 
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C  2  List  entities  in  the 
data  base. 

1  i  tem 
1  var 
i  process 

C  3  Select  entities  to  be 
merged  out. 

s  i  ,messag e 
s  p,chiio 

C  4  Exit  the  Mergeout 
Funct ion 

end 


D  1  Invoke  the  Checkin 
Function  using  the 
same  buffer  and  an 
empty  library. 

ci  l(testiib)  b(testbuf) 


D  2  Describe  the  model 
to  be  checked  in. 

(name)  MODEL 
<number> 

<descr iption> 


AA  1  Invoke  the  Checkout 
Function  using  the 
same  buffer  and 
i ibrary . 

co  l(testiib)  b(testbuf) 


to  reuse  buffer.  User  en¬ 
ters  yes.  prompt  is 

d isplayed . 


Entities  of  the  specified 
types  are  displayed. 
prompt  is  displayed. 


Selected  entities  are 
flagged  to  be  merged  out. 


The  Mergeout  operation  is 
performed.  The  user  is 
returned  to  the  LIBRARY 
READY  level . 


Verification  messages  and 
prompt  displayed.  User 
enters  yes.  User  is  asked 
if  the  library  should  be 
created.  User  enters  yes. 


The  user  is  prompted  for  a 
name,  a  document  reference 
number  and  a  description. 
User  is  asked  if  library 
update  is  to  be  permanent. 
User  enters  yes. 


Verification  messages  and 
prompt  displayed.  User 
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enters  yes 
displayed . 


»  * " 


prompt 


AA  2  List  ail  models  in  the 
data  base. 

1  * 


AA  3  List  the  contents  of 

the  previously  checked 
i n  model . 

1  model 


AA  4  Delete  the  model  from 
the  library. 

d  model 


AA  5  Verify  the  deletion 

with  the  list  command. 

i  * 

AA  6  Exit  the  Checkout 
Function. 

end 


Names  of  models  is  the 
data  base  are  listed. 


The  entities  of  model  are 
listed  as  in  A  3  above. 


The  model  is  deleted, 
prompt  is  displayed. 


Existing  models  are  listed. 


User  is  returned  to  the 
LIBRARY  READY  level. 


Exit  the  Library  level 


end 


User  is  returned  to  the 
A  IS  IN  READY  levei. 


4.  ACCEPTANCE  TESTING 

Acceptance  testing  consists  of  verifying  all  the  operational 
requirements  of  the  system.  Acceptance  testing  for  AISIM  con¬ 
sists  of  the  foregoing  Installation  Tests  as  well  as  the  tests 
described  in  the  following  paragraphs.  The  combination  of  these 
tests  provides  for  verification  of  user  interface  software 
(Installation  Test  Procedures),  exercise  of  all  Library,  Hard¬ 
copy,  Replot,  and  Design  functions  (Installation  Test  Pro¬ 
cedures),  verification  of  the  Translator  (Installation  Tests  and 
Acceptance  Test)  and  verification  of  the  AISIM  simulator  (Accep¬ 
tance  Tests) .  As  can  be  seen  the  Installation  Tests  cover  alx 
system  capabilities  except  the  AISIM  simulator.  Its  capabilities 
are  fuixy  exercised  by  the  five  Acceptance  Tests.  Table  1  shows 
a  cross  reference  of  Acceptance  Tests  and  functional  requirements 
of  the  simulator  tested  by  each  test. 
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TABLE  1 


ACCEPTANCE  TESTING 

FUNCTIONAL  REQUIREMENTS  CROSS-REFERENCE 


1 

1 

1 

2 

1 

3 

1 

4 

1 

5 

_  1 

Random  Number  Seed 

1 

! 

! 

1 

X 

1  1 

Random  Sampling  by  Variable  Dist. 

1 

1 

1 

1 

X 

1 

X 

j 

Arithmetic  Constructs 

I 

X 

1 

1 

X 

1 

X 

Parameter  Passing 

! 

X 

1 

X 

1 

1 

X 

1 

X 

1  ! 

Terminal  Interface  - 

1 

1 

1 

1 

1 

Simulate  for  Multiple  Periods 

1 

1 

1 

1 

X 

1 

Statistical  Summary  Percision 

1 

! 

1 

1 

X 

1 

1 

Queue  Manipulation 

1 

1 

1 

X 

I 

X 

1 

Resource  Logic 

1 

1 

X 

1 

X 

1 

X 

1 

Keywords 

1 

1 

X 

1 

1 

X 

1 

1 

Protocol  Processes 

1 

1 

1 

1 

X 

1 

1 

Resource  Manipulation 

I 

1 

X 

1 

1 

X 

1 

1 

Process  Triggering 

1 

X 

1 

1 

X 

1 

X 

1 

X 

1 

4 . 1  Acceptance  Testing  Procedures 

Each  of  the  five  Acceptance  Tests  are  executed  using  the  same 
procedure.  The  following  paragraph  describes  this  procedure  and 
all  associated  information  necessary  to  perform  the  tests. 

4.1.1  Locate  Acceptance  Tests  Data  Bases  Included  on  the 
delivered  system  tape  are  five  files  labeled  TESTDBA.DBF, 
TESTDBB.DBF,  TESTDBC . DBF ,  TESTDBD. DBF,  and  TESTDBE. DBF.  Each  of 
these  files  are  model  data  bases  that  contain  model  definitions 
which  when  simulated  exercise  a  different  portion  of  the  simula¬ 
tor.  The  data  bases  TESTDBA  through  TESTDBE  are  used  in  tests  1 
through  5  respectively.  When  the  system  tape  was  read  onto  disk, 
these  files  were  read  onto  the  user  ID  specified  in  the  JCL  job 
steps . 

4.1.2  Verify  Test  Data  Bases  To  insure  that  no  errors  were 
introduced  into  the  test  data  bases  during  tape  reads,  etc.  dur¬ 
ing  rehost,  each  data  base  should  be  verified.  This  is  done  by 
entering  AISIM  and  executing  the  Analyze  command  specifying  the 
test  data  base  to  be  verified.  For  example  to  verify  test  data 
base  TESTDBA.DBF  the  testor  should  enter: 

a  p(testdba) 

In  response  the  system  will  issue  Analysis  User  Interface  mes¬ 
sages  and  prompt  for  a  continuation  indication.  After  the  user 
enters  "yes",  the  Translator  will  be  called  and  the  test  data 
base  win  be  translated  and  initialized.  The  system  should  issue 
the  message: 

NO  ERRORS  DETECTED  IN  MODEL  TRANSLATION 
YOU  MAY  NOW  ENTER  COMMANDS 

If  errors  are  detected,  the  test  data  base  is  not  usable.  If  the 
prompt  is  issued  as  shown  above  the  user  should  aiso  verify  ali 
values  within  the  model.  This  is  done  by  exiting  the  Analyze 
function  and  obtaining  a  listing  of  the  report. data  file  for  that 
data  base.  For  example,  to  verify  the  values  for  TESTDBA.DBF  the 
user  should  list  the  tes tdba . r epo r t . d a ta  file.  The  user  should 
then  do  a  line  by  line  comparison  of  this  listing  to  the  listing 
provided  in  Appendix  C  for  the  given  data  base.  If  any  difference 
is  detected,  the  test  data  base  is  unusable.  This  validation 
step  should  be  repeated  against  each  test  data  base. 

4.1.3  Per  form  Test  Enter  the  AISIM  system  and  execute  the 
Analyze  command  specifying  the  test  data  base  to  be  executed.  For 
example  to  execute  test  1,  test  data  base  TESTDBA.DBF  should  be 
executed  by  issuing  the  analyze  command  as  follows: 

a  p(testdba) 

For  tests  2-5,  this  command  would  be  altered  by  inserting  testdbb 
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through  testdbe  respectively.  When  the  prompt: 

NO  ERRORS  DETECTED  IN  MODEL  TRANSLATION 
YOU  MAY  NOW  ENTER  COMMANDS 

is  displayed,  the  user  should  enter  "go".  This  will  execute  the 
simulation  and  the  following  prompt  should  be  displayed: 

SIMULATION  ENDED  -  NORMAL  TERMINATION 
YOU  MAY  NOW  ENTER  COMMANDS 

Any  other  response  indicates  an  error.  The  testor  should  then 
list  the  "test" . report .data  file  for  the  test  just  executed  where 
"test"  is  replaced  by  the  name  of  the  test  data  base  just  exe¬ 
cuted.  For  exampie,  ti  obtain  the  report  for  Test  1  which  uses 
TESTDBA . DBF  the  fire  to  be  listed  is  testdba . r epor t .data .  The 
tester  then  performs  a  line  by  line  comparison  of  the  listing 
obtained  in  this  way  with  the  cor  respond ing  test  results  listing 
provided  in  Appendix  D.  Any  differences  indicate  an  error.  This 
step  is  repeated  for  each  test  data  base. 
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APPENDIX  A 

JCL  FILES  FOR  THE  TAPES 
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OrDIO  TEST  INTERVAL  SCHEDULE  AMO  EVAl  TRIG  FUNCTIONS 


70T4L  97  10006.436  103.159  75.687  10.643  384.404 

PROCESS  Will  0  0.  0.  0.  0.  0. 

RESO'JPCE  Mi  IT  0  0.  0.  0.  0.  0. 


TEST  CP l AUG  DISTRIC'JTIOM 


0FD7  TEST  GA'IMA  OISTPISUTIOM 
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